home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / brltty / Voyager.README < prev   
Text File  |  2009-10-13  |  4KB  |  83 lines
  1. BRLTTY Driver for the Tieman Voyager Braille Display
  2. This is the user-space-only version of the driver.
  3. Version 0.10 (March 2004)
  4.  
  5. Copyright 2004 by StΘphane Doyon  <s.doyon@videotron.ca>
  6.  
  7. This is a partial rewrite of the driver which functions entirely from
  8. user-space (whereas the previous driver depended on a kernel driver for
  9. the USB communication with the Voyager display).
  10.  
  11. This driver supports the Tieman Voyager 44 and 70.
  12.  
  13. The driver works with later 2.4.x kernels and with at least some versions
  14. in the 2.6.x series.
  15. Note that the kernel brlvger driver used with the old BRLTTY driver does
  16. not work properly with 2.6.x kernels.
  17.  
  18. Many thanks to the Tieman people: Corand van Strien, Ivar Illing, Daphne
  19. Vogelaar and Ingrid Vogel. They provided us with a Braille display (as
  20. well as programming information) so that we could write this driver. They
  21. replaced the display when it broke and they answered our technical
  22. questions. It is very motivating when companies take an interest in such
  23. projects and are so supportive.
  24.  
  25. Thanks to Andor Demarteau <ademarte@students.cs.uu.nl> who got this whole
  26. project started and beta-tested all our early buggy attempts.
  27.  
  28. Thanks to StΘphane Dalton who wrote the initial version of the old kernel
  29. driver. Without his initiative this project would not have been a success.
  30.  
  31. This rewrite of the driver should allow more flexibility, but is as of yet
  32. very young and not thoroughly tested.
  33.  
  34. When BRLTTY will be running, press the leftmost routing key to bring up
  35. the help screen so you can read the details of the key bindings.
  36.  
  37. Users of the 2.6.x kernel may experience some difficulties.  The old
  38. kernel driver, which is included in the official kernels, will actually
  39. get in the way of this driver as it will claim the USB interface to the
  40. display, and I've seen some hangs occur when BRLTTY asks to disconnect
  41. the kernel driver. If you have this problem you should make sure the
  42. kernel module called brlvger is not inserted into your kernel. One simple
  43. way to prevent that module from auto-loading is to rename the module file
  44. so it isn't found.
  45. cd /lib/modules/`uname -r`/kernel/drivers/usb/
  46. mv brlvger.o brlvger.o.hold
  47. If lsmod shows the brlvger module as already loaded then do
  48. rmmod brlvger
  49.  
  50. The old kernel driver will soon be pulled out of 2.6.x kernels.
  51.  
  52. BRLTTY currently assumes the default braille device to be a serial port,
  53. so you must tell it that it is in fact USB.
  54. Either provide the "--with-braille-device=usb:" option when running the
  55. BRLTTY top-level ./configure command, or use the braille-device parameter
  56. in your BRLTTY configuration file (/etc/brltty.conf):
  57. braille-device usb:
  58.  
  59. If you actually have more than one Voyager display connected at the same
  60. time, you can also specify the serial number of the device that you want
  61. to use.
  62.  
  63. This driver knows a number of driver parameters which you can pass via
  64. the braille-parameters clause in your BRLTTY configuration file
  65. (/etc/brltty.conf) or via brltty's -B (--braille-parameters=) command
  66. line option.
  67.  
  68. InputMode: This parameter specifies whether or not the eight top keys
  69. function as a braille keyboard. When set to "no" (the default), top
  70. key combinations perform various navigational and operational
  71. functions. When set to yes", they function as an 8-dot braille
  72. keyboard. If B, C, or B+C is pressed along with any top key
  73. combination then it's as if this parameter were set to "no".
  74.  
  75. There are only a handful of BRLTTY users, so if you are trying out this
  76. driver, please drop us a note, even if you have no problems!
  77.  
  78. Note to BRLTTY developers: This is my first attempt at combining the key
  79. binding definitions with the help file text in one place, through
  80. annotations in the braille.c file. If you change the key bindings,
  81. currently you need python installed to be able to rebuild the help
  82. files.
  83.